Release 10.1A: OpenEdge Getting Started:
Installation and Configuration

Configuring OpenEdge Unified Broker log files

A Unified Broker installation generates a total of three log files that, by default, are stored in the working directory. The log file naming convention is as follows: type is the Unified Broker type (for example, AS for AppServer) and instance-name is the name of the Unified Broker or NameServer instance

The log files default names are:

instance-name.broker.log — Unified Broker log file set using the Progress Explorer or the brokerLogFile property in the [Ubroker.type.instance-name] section (for example, [Ubroker.AS.asbroker1]) of the properties file. This log file records the connection and management activity of the Unified Broker instance.
instance-name.server.log — Server process log file set using the srvrLogFile property in the [Ubroker.type.instance-name] section (for example, [Ubroker.AS.asbroker1]) of the properties file. This log file records the activity of server processes that directly handle client requests for the Unified Broker instance.
instance-name.NS.log — NameServer log file set using the srvrLogFile property in the [NameServer.instance-name] section of the properties file. This log file records the activity of the controlling NameServer for a Unified Broker instance.

For disk management reasons, you might want to specify a nondefault location for the log files used by a Unified Broker. After you decide where you want these log files to reside, you can specify the location for each in the Progress Explorer or by directly editing the ubroker.properties file. For more information, see the "Configuring OpenEdge Unified Broker components" section.

You can also view these log files using the Progress Explorer or by using your system text file commands and utilities.

The instance-name.broker.log and NameServer instance-name.log files include:

Information on when Unified Broker and NameServer processes start up and shut down.
System messages and information up to a level of detail that you specify using the Progress Explorer or the loggingLevel property in the ubroker.properties file.

The instance-name.server.log file includes all trace messages and OpenEdge system messages that are not assigned an output destination by the OUTPUT TO KEEP-MESSAGES statement.

Because log files receive Unified Broker and NameServer startup and shutdown messages, OpenEdge system messages, and trace messages, they can grow quickly. Also, they do not truncate automatically and can grow indefinitely. To manage disk space, periodically trim the file with a text editor after archiving any information that you want to save.